[codex] contributor-friendly foundation - #168
Merged
redxzeta merged 2 commits intoAug 30, 2026
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Linked issue / agreed scope
This PR implements the agreed contributor-friendly foundation plan. It keeps the compatibility-sensitive rename work tracked by #128 out of scope and advertises only the concrete contributor-ready work in #145 and #146.
Change summary
Forkara's contributor path had accumulated stale Synara branding, hostile or ambiguous policy language, a public vouch system, duplicated label definitions, and no safe development preset for running beside an installed app. Together, those gaps made routine contributions require maintainer assistance and made the public workflow harder to understand than the project intends.
This change replaces that path with warm, direct onboarding and a curated issue-first lifecycle built around monthly triage. It adds a development guide, security policy, documentation issue form, support and security routing, a concise PR template, and a single label-definition workflow. It removes the vouch list and workflow while retaining GitHub's built-in first-time contributor approval behavior.
The new
bun run dev:contributorpreset reuses the existing development runner while forcing repository-local ignored state, non-default ports, and no inherited server auth token. Live provider credentials are documented as optional for ordinary UI and unit work.Active onboarding documentation now uses Forkara branding and current links. Intentional compatibility identifiers and archived or release-specific material remain unchanged under #128.
Verification
bun run fmt -- '!ui-review-report.md'bun run lint(zero errors)bun run typecheckTURBO_ENV_MODE=loose TMPDIR=/private/tmp bun run test(all 8 workspace tasks passed; server: 4,198 passed, web: 4,272 passed)bun run --cwd scripts test dev-runner.test.ts(26 passed)bun run dev:contributor -- --dry-runbun run readme:truthinessbun run brand:checkbun install --frozen-lockfile, contributor dry-run, and focused runner testThe loose Turbo environment mode passes macOS's canonical
/private/tmpvalue through to two existing reset-department tests that otherwise compare/tmpwith/private/tmp.Compatibility risks
No runtime APIs, persisted schemas, or shared application contracts change. Existing development modes retain their prior inputs and behavior. The contributor preset intentionally ignores inherited auth and explicit state or port overrides so it remains isolated and predictable.
Compatibility-sensitive
SYNARA_*,.synara, and provider protocol identifiers remain in place.After this PR merges, the repository-label workflow should be dispatched and the default-branch ruleset should be created with the four always-running CI checks. The ruleset is intentionally not enabled before its defining PR merges.
UI evidence
Not applicable. This PR changes documentation, contributor forms, repository automation, and development-runner behavior without changing the product UI.